home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / standard / ldgetsymstr.z / ldgetsymstr
Encoding:
Text File  |  2002-10-03  |  2.2 KB  |  54 lines
  1. LDGETSYMSTR(3X)                                       Last changed: 11-5-98
  2.  
  3.  
  4. NNAAMMEE
  5.      llddggeettssyymmssttrr - Gets a symbol type string
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddiioo..hh>>
  9.      ##iinncclluuddee <<ffiilleehhddrr..hh>>
  10.      ##iinncclluuddee <<ssyymmss..hh>>
  11.      ##iinncclluuddee <<llddffccnn..hh>>
  12.  
  13.      iinntt llddggeettssyymmssttrr (("_l_d_p_t_r, _p_s_y_m_r,_i_s_y_m,_b_u_f_f_e_r""))
  14.      LLDDFFIILLEE **_l_d_p_t_r;
  15.      PPSSYYMMRR **_p_s_y_m_r;
  16.      iinntt _i_s_y_m;
  17.      iinntt _f_l_a_g_s;
  18.      cchhaarr **_b_u_f_f_e_r;
  19.  
  20. IIMMPPLLEEMMEENNTTAATTIIOONN
  21.      IRIX systems (o32 ABI only)
  22.  
  23. DDEESSCCRRIIPPTTIIOONN
  24.      llddggeettssyymmssttrr puts, in the caller-provided buffer, a string with the
  25.      information that is available on the symbol passed in.  There is no
  26.      mechanism to prevent buffer overflow, so it is best to provide a large
  27.      buffer.  2048 bytes should be 10 or 20 times the size of any
  28.      reasonable string.  The string put in _b_u_f_f_e_r is terminated by a
  29.      null(0) byte by llddggeettssyymmssttrr.
  30.  
  31.      Both a symbol index (as is supplied to llddttbbrreeaadd )) and a ppSSYYMMRR pointer
  32.      pointing to the data for the indexed symbol (previously filled by a
  33.      call to llddttbbrreeaadd) must be passed to llddggeettssyymmssttrr.
  34.  
  35.      llddggeettssyymmssttrr returns SSUUCCCCEESSSS if it has  been able to access the symbol
  36.      table or NNUULLLL, if it has not.
  37.  
  38.      If the symbol is simply a label (as in assembler code), the string put
  39.      in the buffer will be of length 0 (that is, the zero byte of the
  40.      buffer will be set to 0).
  41.  
  42.      The program must be loaded with the object file access routine library
  43.      lliibbmmlldd..aa.
  44.  
  45.      iinnttrroo(4) describes IINNCCDDIIRR and LLIIBBDDIIRR.
  46.  
  47. SSEEEE AALLSSOO
  48.      ffooppeenn(3S), llddcclloossee(3X), llddooppeenn(3X), llddttbbrreeaadd(3X)
  49.  
  50.      iinnttrroo(4), llddffccnn(4)
  51.  
  52.      This man page is available only online.
  53.  
  54.